Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update plugins.md with semver range support specification #6733

Merged
merged 17 commits into from
Mar 21, 2024

Conversation

kolchfa-aws
Copy link
Collaborator

@kolchfa-aws kolchfa-aws commented Mar 20, 2024

Add support for specifying 'dependencies' for a plugin in its plugin-descriptor.properties file. This property allows for specification of a range of OpenSearch versions for plugin compatibility check.

Description

Describe what this change achieves.

Issues Resolved

Closes #6433

Checklist

  • By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license and subject to the Developers Certificate of Origin.
    For more information on following Developer Certificate of Origin and signing off your commits, please check here.

Add support for specifying 'dependencies' for a plugin in its plugin-descriptor.properties file. This property allows for specification of a range of OpenSearch versions for plugin compatibility check.

Signed-off-by: abseth-amzn <[email protected]>
@hdhalter hdhalter added 4 - Doc review PR: Doc review in progress release-notes PR: Include this PR in the automated release notes v2.13.0 labels Mar 20, 2024
@hdhalter
Copy link
Contributor

Thanks for this submission, @abseth-amzn! Can you please address the errors? If you have any questions about anything, please let us know.

@kolchfa-aws kolchfa-aws self-assigned this Mar 20, 2024
_install-and-configure/plugins.md Outdated Show resolved Hide resolved
_install-and-configure/plugins.md Outdated Show resolved Hide resolved
_install-and-configure/plugins.md Outdated Show resolved Hide resolved
_install-and-configure/plugins.md Outdated Show resolved Hide resolved
_install-and-configure/plugins.md Outdated Show resolved Hide resolved
_install-and-configure/plugins.md Outdated Show resolved Hide resolved
_install-and-configure/plugins.md Outdated Show resolved Hide resolved
_install-and-configure/plugins.md Outdated Show resolved Hide resolved
_install-and-configure/plugins.md Outdated Show resolved Hide resolved
_install-and-configure/plugins.md Outdated Show resolved Hide resolved
abseth-amzn and others added 13 commits March 21, 2024 10:39
Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>
Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>
Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>
Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>
Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>
Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>
Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>
Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>
Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>
Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>
Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>
Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>
Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>
@abseth-amzn
Copy link
Contributor

Thanks for this submission, @abseth-amzn! Can you please address the errors? If you have any questions about anything, please let us know.

Thanks for the suggestions! I have accepted all of them.

Copy link
Collaborator

@natebower natebower left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@kolchfa-aws Just a few minor changes. Thanks!

@@ -247,8 +247,23 @@ bin/opensearch-plugin install --batch <plugin-name>

## Available plugins

Major, minor, and patch plugin versions must match OpenSearch major, minor, and patch versions in order to be compatible. For example, plugins versions 2.3.0.x work only with OpenSearch 2.3.0.
{: .warning}
OpenSearch provides several bundled plugins and additional plugins.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"several bundled and additional plugins"?

_install-and-configure/plugins.md Outdated Show resolved Hide resolved
_install-and-configure/plugins.md Outdated Show resolved Hide resolved
@kolchfa-aws
Copy link
Collaborator Author

@abseth-amzn Please accept editorial suggestions, and we'll be ready to merge this PR. Thanks!

abseth-amzn and others added 3 commits March 21, 2024 22:39
Co-authored-by: Nathan Bower <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>
Co-authored-by: Nathan Bower <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>
Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>
@abseth-amzn
Copy link
Contributor

I have accepted all the suggestions.

@kolchfa-aws kolchfa-aws merged commit d261cf1 into opensearch-project:main Mar 21, 2024
3 checks passed
CaptainDredge pushed a commit to CaptainDredge/documentation-website that referenced this pull request Mar 22, 2024
…-project#6733)

* Update plugins.md with semver range support specification

Add support for specifying 'dependencies' for a plugin in its plugin-descriptor.properties file. This property allows for specification of a range of OpenSearch versions for plugin compatibility check.

Signed-off-by: abseth-amzn <[email protected]>

* Update _install-and-configure/plugins.md

Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>

* Update _install-and-configure/plugins.md

Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>

* Update _install-and-configure/plugins.md

Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>

* Update _install-and-configure/plugins.md

Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>

* Update _install-and-configure/plugins.md

Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>

* Update _install-and-configure/plugins.md

Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>

* Update _install-and-configure/plugins.md

Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>

* Update _install-and-configure/plugins.md

Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>

* Update _install-and-configure/plugins.md

Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>

* Update _install-and-configure/plugins.md

Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>

* Update _install-and-configure/plugins.md

Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>

* Update _install-and-configure/plugins.md

Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>

* Update _install-and-configure/plugins.md

Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>

* Update _install-and-configure/plugins.md

Co-authored-by: Nathan Bower <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>

* Update _install-and-configure/plugins.md

Co-authored-by: Nathan Bower <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>

* Update _install-and-configure/plugins.md

Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: abseth-amzn <[email protected]>

---------

Signed-off-by: abseth-amzn <[email protected]>
Co-authored-by: abseth-amzn <[email protected]>
Co-authored-by: Nathan Bower <[email protected]>
@hdhalter hdhalter added 3 - Done Issue is done/complete and removed 4 - Doc review PR: Doc review in progress labels Mar 22, 2024
```properties
opensearch.version=2.3.0
```
Alternatively, a plugin can specify a range of compatible OpenSearch versions by setting the `dependencies` property in its `plugin-descriptor.properties` file using one of the following notations:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

shouldn't you specify that this is only available starting with 2.13.0? (all your examples currently use 2.3.0 where it wouldn't even work)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
3 - Done Issue is done/complete release-notes PR: Include this PR in the automated release notes v2.13.0
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[DOC] Document support for semver range specification for plugin compatibility for 2.13.0
5 participants